package cn.tedu._02notice.controller;

import cn.tedu._02notice.base.response.JsonResult;
import cn.tedu._02notice.base.response.StatusCode;
import cn.tedu._02notice.mapper.NoticeMapper;
import cn.tedu._02notice.pojo.dto.NoticeAddParam;
import cn.tedu._02notice.pojo.dto.NoticeListQuery;
import cn.tedu._02notice.pojo.dto.NoticeUpdateParam;
import cn.tedu._02notice.pojo.entity.Notice;
import cn.tedu._02notice.pojo.vo.NoticeDetailInfoVO;
import cn.tedu._02notice.pojo.vo.NoticeListVO;
import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.Parameter;
import io.swagger.v3.oas.annotations.Parameters;
import io.swagger.v3.oas.annotations.tags.Tag;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.BeanUtils;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.*;

import java.util.Date;
import java.util.List;

/**
 * RestController注解:
 *   1.组合注解,等价于 Controller + ResponseBody 注解;
 *   2.该注解会在每个控制器方法上添加@ResponseBody注解;
 * Slf4j注解:
 *   1.Lombok提供的日志注解,添加在类上,会自动生成日志对象log;
 *   2.日志对象log,会自动生成,使用日志对象log,记录日志;
 *     log.trace("xxx");
 *     log.debug("xxx"); -------------使用最多,开发过程中需要打印调试日志;
 *     log.info("xxx");
 *     log.warn("xxx");
 *     log.error("xxx"); -------------经常使用,记录错误日志[在全局异常处理器中使用较多];
 *  Knife4j注解:
 *    1.Tag(name=""): 调整控制器类名在Knife4j文档中的显示名称;
 *    2.Operation(summary = "xxx"): 添加方法名称,在Knife4j文档中显示的方法名称;
 *    3.ApiOperationSupport(order = 10): 方法排序,数字越小越靠前[优先级越高];
 *    4.Schema(description="xxx",required=true,example="xxx"): 封装参数属性的描述,是否必须,示例值;
 *    5.Parameter(name="xxx",description="xxx",required=true,example="xxx"): 单个非封装参数描述;
 *    6.Prameters(value = {}): 封装多个非封装参数的描述;
 */
//@Controller
@Slf4j
@RestController
@Tag(name = "01-资讯管理模块")
@RequestMapping("/v1/notice")
public class NoticeController {
    //自动装配
    @Autowired
    private NoticeMapper noticeMapper;

    /**
     * 1.添加资讯功能
     * @param noticeAddParam
     * @return
     */
    @PostMapping("/add")
    @Operation(summary = "添加资讯")
    @ApiOperationSupport(order = 10)
    @Parameters(value = {
            @Parameter(name = "title", description = "标题"),
            @Parameter(name = "content", description = "内容"),
            @Parameter(name = "type", description = "类型"),
            @Parameter(name = "status", description = "状态"),
            @Parameter(name = "noticeAddParam", hidden = true)
    })
    public JsonResult add(NoticeAddParam noticeAddParam){
        log.debug("noticeAddParam = " + noticeAddParam);
        //终极目标:将资讯信息保存到数据库中; new Notice().var + 回车 + 回车
        Notice notice = new Notice();
        //复制属性
        BeanUtils.copyProperties(noticeAddParam, notice);
        //处理其他属性
        notice.setUserId(1L);//暂时写死,后续一定是登录用户的ID
        notice.setCreateTime(new Date());
        notice.setUpdateTime(new Date());
        log.debug("notice = " + notice);
        //光标放在insertNotice上,Alt + 回车 + 回车
        noticeMapper.insertNotice(notice);

        //{"state":2000, "message":"添加资讯成功", "data":null}
        return JsonResult.ok();
    }

    /**
     * 2.资讯列表功能
     */
    @GetMapping("/list")
    @Operation(summary = "资讯列表")
    @ApiOperationSupport(order = 20)
    public JsonResult list(NoticeListQuery noticeListQuery){
        log.debug("noticeListQuery = " + noticeListQuery);
        List<NoticeListVO> noticeListVOS = noticeMapper.listNotice(noticeListQuery);

        //{"state":2001, "message":"查询成功", "data": [{},{},{},...]}
        return JsonResult.ok(noticeListVOS);
    }

    /**
     * 3.资讯详情功能
     */
    @GetMapping("/detail")
    @Operation(summary = "资讯详情")
    @ApiOperationSupport(order = 30)
    @Parameters(value = {
            @Parameter(name = "id", description = "资讯ID", required = true, example = "1"),
            @Parameter(name = "name", description = "名称", required = true, hidden = true)
    })
    public JsonResult detail(Long id, String name){
        //name参数只是为了演示Knife4j多个非封装参数的描述,没有其他作用;
        log.debug("id = " + id);
        NoticeDetailInfoVO noticeDetailInfoVO = noticeMapper.getNoticeDetailInfoById(id);

        return JsonResult.ok(noticeDetailInfoVO);
    }

    /**
     * 4.删除资讯功能
     */
    @DeleteMapping("/del")
    @Operation(summary = "删除资讯")
    @ApiOperationSupport(order = 40)
    public JsonResult del(Long id){
        log.debug("id = " + id);
        int i = noticeMapper.deleteNoticeById(id);
        if (i > 0){
            return JsonResult.ok();
        }
        return new JsonResult(StatusCode.OPERATION_FAILED);
    }

    /**
     * 5.修改资讯功能
     *   UPDATE notice
     *   SET title = ?, content = ?, type = ?, status = ?, update_time = ? WHERE id = ?
     *   UPDATE notice
     */
    @PostMapping("/update")
    @Operation(summary = "更新资讯")
    @ApiOperationSupport(order = 50)
    public JsonResult update(@RequestBody NoticeUpdateParam noticeUpdateParam){
        log.debug("noticeUpdateParam = " + noticeUpdateParam);
        Notice notice = new Notice();
        //1.复制属性
        BeanUtils.copyProperties(noticeUpdateParam, notice);
        //2.处理其他属性[必要的]
        notice.setUpdateTime(new Date());
        log.debug("notice = " + notice);
        //3.调用接口
        int i = noticeMapper.updateNoticeById(notice);
        log.debug("i = " + i);
        if (i > 0){
            return JsonResult.ok();
        }
        return new JsonResult(StatusCode.OPERATION_FAILED);
    }
}
















